home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 2000 November: Tool Chest / Dev.CD Nov 00 TC Disk 1.toast / Sample Code / Archive / Networking / GetZoneList / README < prev    next >
Encoding:
Text File  |  2000-09-28  |  2.7 KB  |  71 lines  |  [TEXT/MPS ]
  1. Macintosh
  2. Sample Code Notes
  3. _____________________________________________________________________________
  4.                                                   Developer Technical Support
  5.  
  6. #11:    GetZoneList
  7.  
  8. Written by:    Mark Bennett & Pete Helme
  9.  
  10. Versions:        1.00                November 1988
  11.                 1.01                October 1989
  12.                 1.02                May 1990
  13.                 1.03                June 1992
  14.                 1.04                July 1992
  15.  
  16. Components:        GetZoneList.c        May 1, 1990
  17.                 GetZoneList.p        May 1, 1990
  18.                 GetZoneList.r        May 1, 1990
  19.                 Makefile            May 1, 1990
  20.  
  21. Required:        UFailure.a            November 1, 1988
  22.                 UFailure.h            November 1, 1988
  23.                 UFailure.incl.p        November 1, 1988
  24.                 UFailure.p            November 1, 1988
  25. _____________________________________________________________________________
  26.  
  27. This program needs MPW 3.2 or greater to build. It also requires that you
  28. copy the necessary files from the UFailure UNIT (originally distributed as
  29. part of SC.012.Signals) to the GetZoneList folder.
  30. _____________________________________________________________________________
  31.  
  32. GetZoneList is a sample application that uses AppleTalk's AppleTalk
  33. Transaction Protocol (ATP) and Zone Information Protocol (ZIP) to obtain a
  34. list of zones on an AppleTalk internet.  It also demonstrates using a signal,
  35. or failure-catching mechanism, to recover from error situations.
  36.  
  37. GetZoneList is based on Sample, and DTS recommends that you review Sample or
  38. TESample for the general structure and MultiFinder techniques you should use
  39. when writing a new application.
  40.  
  41. Changes for Version 1.02
  42. ________________________
  43.  
  44. A node exists on a valid internet if, and only if, 1) GetBridgeAddress
  45. returns a non-zero router address and 2) GetNodeAddress returns a non-zero
  46. network number.  If there is a valid network number, but no router, one
  47. cannot obtain zone information, and there cannot be a internet.  The
  48. previous version of GetZoneList only checked GetNodeAddress, which could
  49. show a non-zero network number in the presence of a half router.  This
  50. current version now makes the appropriate check in the procedure
  51. BuildZoneList.
  52.  
  53. Changes were also made to support AppleTalk Phase 2 in accordance with
  54. Technical Note #250, "AppleTalk Phase 2 on the Macintosh."  See procedures
  55. ZoneListCleanUpPhase2 and BuildZoneListPhase2.
  56.  
  57. Changes for Version 1.03
  58. ________________________
  59.  
  60. Since the MPW 3.2 AppleTalk.h header file contains AppleTalk Phase 2 data
  61. stuctures, the typedefs were removed and the header file types were used.
  62.  
  63. Changes for Version 1.04
  64. ________________________
  65.  
  66. With the introduction of AppleTalk Remote Access, one can be on network
  67. zero and be connected to a remote network.  GetZoneList now looks only at
  68. the result of GetBridgeAddress() to determine if an internet is attached.
  69. See Macintosh Technical Note #311: "What's New With AppleTalk Phase 2"
  70. for more details.
  71.